Using single textures

Single textures use a single image for the texture.

Before you can create a texture in Kanzi Studio you first have to create the texture image. You can create the texture image in a third-party tool and import the image to Kanzi Studio. See Importing images.

Make sure that the image and texture formats match. When image and texture formats do not match, Kanzi Engine converts them when your during the loading of your Kanzi application using the CPU of the target platform. This can significantly increase the amount of time it takes to launch your application.

For example, if a texture is grayscale and uses transparency, in Kanzi Studio set the texture Format property to Grayscale alpha (8-bit) instead of, for example, RGBA (8-bit). A 256 by 256 pixels RGBA texture uses 262 kb (256 * 256 * 4). When you use grayscale with alpha channel, the same texture uses 131 kb (256 * 256 * 2).

When image and texture formats do not match, Kanzi Studio prints this warning to the Log window:

Application WARNING: The format of the texture '<TextureName>' does not match the format of the image '<ImageName>'.
	To improve the performance of your application, make sure the formats of the image and the texture match.

Creating a single texture

To create a single texture:

In the Library right-click Materials and Textures > Textures and select Create > Single Texture.
In the Properties set the Image property to the image you want to use for your texture.

Using a single texture

You can use single textures on meshes and image layers:

To use the texture on a mesh, assign the texture to a material that supports textures. See Creating textured materials.
To use a single texture on an Image Layer, in the Project select the image layer, and in the Properties set the Image property to the single texture you want to use on the image layer.

Using single textures

Creating a single texture

Using a single texture

See also